home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / appicon tools / newtrashcan / doc / doc.english next >
Text File  |  1996-04-07  |  17KB  |  421 lines
  1.  
  2. ---------------------------------------------------------------------
  3.  
  4.  
  5.                              NewTrashcan
  6.  
  7.             The new File-Trashcan for the AMIGA-Workbench
  8.  
  9.                       requires OS 2.0 or higher
  10.  
  11.        Harddrive or at least a second diskdrive is recommended!
  12.  
  13.         With OS 2.1 or higher the locale.library is supported
  14.  
  15.  
  16. ---------------------------------------------------------------------
  17.  
  18.  
  19. Preface:
  20.  
  21. NewTrashcan  lets  you  see  WB's  ordinary  Trashcan  from  a totally
  22. different side.
  23.  
  24. If  the  Trashcan  was  treat  neclegted  upto this time, so this will
  25. change now, with NewTrashcan!
  26.  
  27. What will change?
  28.  
  29. NewTrashcan     will    install    after    starting    a    so-called
  30. CommoditiesHandler. It 'supervises' then all activities from the user.
  31. Don't   panic,  this  supervising  concentrates  itself  only  on  the
  32. activities on the workbench.
  33.  
  34. If this handler is installed, each disk-change and every icon put into
  35. the  trashcan  will  be recognized. Intern to each throw-away-file the
  36. date will be noted down. Is a file stored long enough in the trashcan,
  37. it will be deleted.
  38.  
  39.  
  40. To the program:
  41.  
  42. NewTrashcan  is  divided up in two parts, the described handler, which
  43. runs  as an commodity, so it can be stopped or removed with 'Exchange'
  44. (but I don't see a reason why....).
  45.  
  46. The second part is the accompanying preferences-program, where you can
  47. enter  the  disks  to  supervise and the time, how long a file will be
  48. stored before deleting.
  49.  
  50. First contacts/installing:
  51.  
  52. To  use  NewTrashcan it have to be installed. That's very easy via the
  53. Install-file  in  the  program-archive.  Just  choose the file in your
  54. prefered  language. Harddisk-users can, if they booted normally, start
  55. the   program  immediately,  otherwise  just  boot  again  with  their
  56. harddisk.
  57.  
  58. For  disk-users  it  is a little bit more difficult, and 1-drive-users
  59. should not use NewTrashcan, because it refers the bootdisk very often.
  60. So  the 2-or-more-drive-users should have the bootdisk in one of their
  61. drives  (later  more).  To  install  it, just boot from your most-used
  62. disk. But on this drive there must be at least a free space from 65kB,
  63. or  better more, because the whole program-data, that grows with every
  64. new supervised disk, is stored on your boot-device. If there is enough
  65. space, you can start the install-program.
  66.  
  67. During  the  installation  the  two  programs  will  be  copied in the
  68. belonging  drawers  on  the boot-disk/partition. This is the WBStartup
  69. for the handler and the Prefs-drawer for the preferences-program. With
  70. the  next  booting  the program will be implemented in your system. To
  71. start  it  now,  just  double-click  the  handler  in  your WBStartup.
  72. Additional  to  this  the  locale-data will be copied into the logical
  73. device LOCALE: (if exists), which contains the language-files.
  74.  
  75. How to install his own NewTrashcan:
  76.  
  77. If  the  program  is  installed  and  started (a new boot or start the
  78. handler  by  hand)  the  first  thing  you  should  do is to start the
  79. preferences-tool, otherwise NewTrashcan does definitely nothing!
  80.  
  81. If  the  preferences-tool is started a window is opened with different
  82. switches  and  lists  (by  the  way they're all 'font-sensitive', that
  83. means  they  will  change their size to fit to the actual system-font)
  84. and  pull-down-menues.  But before I describe them in all details I'll
  85. explain you the scope of the preferences-program:
  86.  
  87. Here  you  can choose the disks/partitions to supervise. If one of the
  88. named  disks  will  be inserted now, NewTrashcan checks out for files,
  89. which  are  longer  than the defined time stored in the disks trashcan
  90. and  deletes them. Also each file will be noticed that is put into the
  91. trashcan (incl. the date).
  92.  
  93. But  you  as  user  don't  have  to  install  these  very  complicated
  94. structures  (this  would  be  realy  silly),  because  YOU  have  that
  95. prefs-program
  96.  
  97.  
  98. The Preference-Program
  99.  
  100. As told, this program opens a window with the following switches and
  101. their functions:
  102.  
  103. In  the  upper fifth part (well, +/-) you can edit the global settings
  104. for  the  handler.  In  the  actual version of this program, there are
  105. 'only' checkbox-gadgets, that are on/off-switches.
  106.  
  107. SAFETY REQUESTER:   When this function is active you will be asked if
  108.                     this file should be realy deleted. Then you can
  109.                     enter either to
  110.                       - delete this file
  111.                       - delete all files
  112.                       - not to delete this file or
  113.                       - delete no file.
  114.                     But in the long run this requester can be very
  115.                     annoying, that's why you can turn this requester
  116.                     off (if you trust in this program ;-).
  117.  
  118. NOTE  DEL-PROTECT:  Each  file  can be delete-protected. But who takes
  119.                     care,  especially  on the workbench, if man puts a
  120.                     File into trashcan?  Only DOS! Is this function is
  121.                     active,  NewTrashcan  also   takes  care   of  it,
  122.                     otherwise  -  DELETE FILE!!  The  danger  in  this
  123.                     function is, that there will be files  deleted you
  124.                     never wanted to.
  125.  
  126.  
  127.  
  128. WB-TOOLS  MENU:  Is this function active, the handler will also appear
  129.                  in  the WB's Tools-Menu, but therefor the handler has
  130.                  to be  restarted, so  don't be  surprised if  nothing
  131.                  happens  immediately.  If you select  this  menupoint
  132.                  later,  all  selected  icons will  be  moved into the
  133.                  trashcan.   But  this  disk   have  to  be  known  by
  134.                  Trashcan,  otherwise  it won't work. The only problem
  135.                  is, that the  workbench don't realize this  move, and
  136.                  the icons are  displayed  still in their old windows.
  137.                  But don't panic,  an update via Workbench-menue shows
  138.                  the changes.  Maybe a further WB-release will realize
  139.                  this things automatically.
  140.  
  141. WAIT EXACT:      Is this function is active, not just the date will be
  142.                  noted down for files put into  the trashcan, even the
  143.                  time  of this  action will  be stored.  If a  file is
  144.                  stored long enough in the trashcan it will be deleted
  145.                  as  soon  after  0.00 o'clock  as possible,  if  this
  146.                  function is  deactivated. Otherwise, the file will be
  147.                  deleted  as soon after the  time it was put  into the
  148.                  trash.
  149.  
  150. Below  these  4 small and damn long to explain functions is this part,
  151. where  NewTrashcan becomes familiar with the disks (well, with disks I
  152. also  mean  here  and  in  future Harddrives). ("My name is Partition,
  153. Work:-Partition!")
  154.  
  155. On  the  left  you can see all disks known to NewTrashcan, well, after
  156. the first start, after the installation, there is quiet nothing....
  157.  
  158. To  the right is the button 'Sort list', which sorts the list of disks
  159. an  an  alphabetical  order.  Below you can enter the number of days a
  160. file  should  be  stored on the highlighted disk. If you enter 0 (that
  161. means:  sero),  a  file  is deleted immediately, if it is put into the
  162. trashcan!
  163.  
  164. Below this list there are three further buttons (ok ok, there are six,
  165. but the other three buttons will be explained later, because they have
  166. nothing to do with the disk-list):
  167.  
  168. ADD:     Picks up a new disk in the list.  Therefor a new window opens
  169.          with all at  this moment to the system known disks. So if you
  170.          want to enter a  new disk to  the list, this disk  have to be
  171.          entered in  one of  your drives.  But  before  the preference
  172.          inserts a disk in  its list  of 'VID'  (Very Important Disks)
  173.          it examines the disk for a trashcan. Don't panic, NewTrashcan
  174.          realizes also renamed  trashcans (like 'garbage' or 'trash'),
  175.          because it don't looks out for the names,  but for the icon's
  176.          type.
  177.  
  178. CHANGE:  If  you  for  exapmle  changed  the  name  of a  disk or  the
  179.          trashcan,  so you  can change these things also in  the list.
  180.          Therefor the disk-list-window appears again.
  181.  
  182. REMOVE:  Removes the highlighted disk without any request from the
  183.          list.
  184.  
  185.  
  186. Before I come to the 3 last buttons the remark, that this window is an
  187. AppWindow,  that means you can put an icon from the Workbench into the
  188. NewTrashcan-Window. Convientally this should be disk-icons, which will
  189. be implemented in the VID-list, if a trashcan on this disk exists. You
  190. can also take drawers instead of the disk-icon or the trashcan itself,
  191. it  will  have  the same effect. Only file-icons will not be accepted.
  192. Yes,  ok,  sound a little bit silly, but a file has nothing to do with
  193. the preference-program, and a drawer is a division of the disk....
  194.  
  195.  
  196. The last three buttons:
  197.  
  198. SAVE:   Saves  the  settings and  the disk-list, well, for the further
  199.         starts of NewTrashcan. Quits the preference-program.
  200.  
  201. USE:    The settings and the  list are not saved,  but will be used by
  202.         the  handler. This function is only usefull, if global setting
  203.         changes  are performed,  but  was  implemented,  because  this
  204.         function has to  be in a preference-program.  The  preference-
  205.         program quits.
  206.  
  207. CANCEL: Quits  the  preference-program  without  saving  or  using the
  208.         changes.  This  will  also  be  done  when  clicking   on  the
  209.         close-gadget of the window!
  210.  
  211.  
  212. The Pull-Down-Menus:
  213.  
  214. Because  NewTrashcan  is  not  a  typical  preference-program, I did'n
  215. implement all typical pull-down-menus.
  216.  
  217. The Project-Menu:
  218.  
  219. ABOUT:  Opens a small window with program-infos, Copyright, my adress,
  220.         etc...
  221.  
  222. QUIT:   Quits the program like the CANCEL-Button.
  223.  
  224.  
  225. The Edit-Menu:
  226.  
  227. LAST SAVED:  Loads the last saved settings.
  228.  
  229. RESTORE:     Uses the settings actual by program-start.
  230.  
  231. CLEAR LIST:  Deletes, without request, the Disk-List (VID).
  232.  
  233.  
  234. That's all folks!
  235.  
  236.  
  237. Some interna about the handler:
  238.  
  239. As  said,  the  handler  is  an  Commodity,  it  can  be stoped by the
  240. 'Exchange'-programm on your workbench.
  241.  
  242. In addition to that you can define some things via Tool-Types:
  243.  
  244. 'CX_PRIORITY=':  here  you  can  enter  the priority of the commodity,
  245. default is 0.
  246.  
  247. 'PRIORITY=':  here you can enter the priority of the handler , default
  248. is  0, sometimes -1 is useful, bur don't enter values over 10 or under
  249. -5,  this  is  senseless  or  even dangerous for the system (e.g. with
  250. higher values than the workbench- or the second task).
  251.  
  252. 'DELAY':  If  this tool-type is set, the handler waits after its start
  253. five  seconds,  until  it checks the inserted disks and deletes files.
  254. This is convenient, if you under OS-3.0 (or OS2.0 with e.g. NICKPREFS)
  255. put  a  IFF-Picture in your WB-Background, which has to be loaded. But
  256. more accesses to a disk or a harddrive a time reduces the performance,
  257. so you can let NewTrashcan wait, until it starts with its work.
  258.  
  259. To  regognize the movement of files into the trashcan, the handler has
  260. to  patch  the DOS-function RENAME. Every renaming or moving of a file
  261. now  runs  over this patch. This patch will report the new name to the
  262. handler  which  it  will  call  the  normal  RENAME-function. Well, it
  263. doesn't  inform  the  handler  directly,  the  data  will be sent to a
  264. further task which will tell the things to the handler. This task runs
  265. with a priority of 100, and not without a reason: If the patch sends a
  266. message  (a report about a RENAME-call), it has to be answered to this
  267. mail,  too.  But  the  patch  don't  have  enough time to wait for the
  268. handler,  because  it  may  scan an other Trashcan-directory or delete
  269. something.  The  further task, which will be started immediately after
  270. sending  the information, gets the message, copies it so the patch can
  271. go  on,  sends  now the copy to the handler and waits with any loss of
  272. time  for  the  user  for the reply. The handler now examines the name
  273. given  to  the  RENAME-function  for a known disk and a known trashcan
  274. directory.  If  this  examination was successful, the correspondending
  275. trashcan-directory  will  be  read  in,  new files are stored with the
  276. actual  date  in  the  filelist.  Because  this  filelist is stored in
  277. ENVARC: the bootdisk must be available by disk-systems.
  278.  
  279. Unfortunately   this   patch   doesn't   comply   with  the  commodore
  280. guidinglines,  but  there  is no other way to control moving of files,
  281. because the DOS-function NOTIFY only realizes the creation or changing
  282. of a file.
  283.  
  284.  
  285. The  program  runs under OS-3.0 and has been tested successfully under
  286. OS-2.0.  Under  2.1  or  up the locale.library is supported to display
  287. texts in different languages
  288.  
  289.  
  290. Copyright, PD-Info, the author:
  291.  
  292. Both programs are written with KICK-Pascal 2.0 (MAXON-Computer)!
  293.  
  294. Both programs are FREEWARE, together in one paket they could be copied
  295. freely.  The  copyright  is  however by the author, any changes on the
  296. program  or  its  using  for  other  purposes  or comercial selling is
  297. strictly  forbidden.  There  is  no liability or responsibility by the
  298. author for damages caused by NewTrashcan.
  299.  
  300. This  program can be spreaded via electronic or verbatim way and it is
  301. even  welcome  to  make  the  comfort  of  the  program  accessible to
  302. everyone. The price for a PD-disk may not be higher than 6,- DM!
  303.  
  304. Should  there  be  an  interest  on  versions  of Newtrashcan in other
  305. languages, so I can gladly create further catalog-files and add them.
  306.  
  307. The  translations  have  to be sent together with the german originals
  308. (even  for  the  installation). If required, man can receive a special
  309. catalog-file, where the translation have to be inserted.
  310.  
  311. To this time (22/06/1993) are following languages are available, where
  312. german  is the built-in-language and it will appear in systems with no
  313. locale.library.
  314.  
  315. - Deutsch
  316. - English
  317.  
  318. If man uses the program or is interested in non-german version, can
  319. reach my via snailmail/E-Mail:
  320.  
  321. My Snail-Adress:
  322.  
  323.                            Juergen Schmitz
  324.                             Bergstraße 82
  325.  
  326.                          D-56859 Bullay/Mosel
  327.  
  328. or via FIDO:
  329.  
  330.                     Juergen Schmitz, 2:245/5630.3
  331.  
  332.  
  333. via AMIGA-NET:
  334.       
  335.                     Juergen Schmitz, 39:172/401.2
  336.  
  337.  
  338. via Z-Netz:
  339.  
  340.                          CONFUSIOR@NG-BOX.ZER
  341.  
  342.  
  343.  
  344. If you want to have a fast answer, just write via snail or via Fido,
  345. and if you have FAX, tell me your number.....
  346.  
  347. That's  enough for description. The programs are without any errors (I
  348. hope),  otherwise  send  me a details description of the failure (like
  349. computer, RAM, OS,....). The most of the wrong handling will be caught
  350. but  of course even a master of the silliest combinations (I'm talking
  351. about myself!) cannot attend all possibilities! ;-)
  352.  
  353. Have fun now, and may the Trashcan get more respekt now!
  354.  
  355. I  like  this program, it is running on my system now (30/06/93) for a
  356. few weeks without any problems.
  357.  
  358. ----------------------------------------------------------------------
  359.  
  360. For a hardcopy from this description I would recommend 'SuperPrint',
  361. because it is realy good (I have written it!). A '.sprint'-File is
  362. added to the manual, so with SuperPrint3.0 a Table Of Contents is
  363. printed automatically.
  364.  
  365. --------------------------------------------------------------------w-
  366.  
  367. HISTORY:
  368.  
  369. Sorry, exact history-report only in the german documentation!
  370.  
  371.  
  372. Version   Version   Version   Remark
  373. Paket     Handler   Prefs
  374.  
  375.  1.1        1.3b      1.3      First release
  376.  1.2        1.3b      1.3      Versionlist included to docu, bug in
  377.                                Install-file (english)
  378.  
  379.  1.3        1.4       1.3      .sprint file added to paket
  380.                                Commodore Installer used
  381.  
  382.  1.4        1.4       1.4      Prefs Version 1.4
  383.  1.5        1.5       1.5      Versions 1.5, new locale-files
  384.  1.6        1.6       1.5      Handler V1.6, new FIDO-Adress
  385.  1.7        1.6       1.6      Prefs V1.6
  386.  1.8        1.7       1.7      Versions 1.7, LOCALE-files improved
  387.  1.9        1.8       1.7      Handler Version 1.8
  388.  2.0        1.9       1.8      Handler V1.9, Prefs V1.8, 
  389.                                now with english doc-file
  390.  2.0        1.9       1.9      Prefs V1.9
  391.  2.1        2.0       2.0      Handler & Prefs V2.0
  392.  
  393. ---------------------------------------------------------------------
  394.  
  395. Known bugs:
  396.  
  397. Sometimes  an  '.info'-file  will not be deleted, but I can't find any
  398. regularity.  That's not such a big problem, because it will be deleted
  399. later,  after  the  directory  is scanned again. This bug only appears
  400. only with a storationtime of zero days.
  401.  
  402. There  are  no  known further bug at this time. In the releases before
  403. 1.5 the handler had had problems with some other programs, because the
  404. compiler  seizes  to  global  values  within the patch (special by the
  405. includes).
  406.  
  407. ---------------------------------------------------------------------
  408.  
  409. Thanks:
  410.  
  411. Thanks  to  all  the  sysops who have tested the program and put it in
  412. their  boxes,  specially Robert Britz. He made the OS-2.0-Test (I only
  413. have OS3.0 ;-) I hope, his system had had no realy hard crashes...
  414.  
  415. Matthias  Wege  for  the  english  translation  of the original german
  416. manual. Well done! ;-)
  417.  
  418. ---------------------------------------------------------------------
  419.  
  420. JS/07
  421.